home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / timex.z / timex / man / catn / sumtimex.n next >
Text File  |  1994-09-27  |  4KB  |  199 lines

  1.  
  2.  
  3.  
  4. SUMTIMEX(24 May 1993M)ISC. REFERENCE MANUAL PAGES
  5.  
  6.  
  7.  
  8. NAME
  9.      sumtimex - printing out how many hours you worked last week
  10.  
  11. SYNOPSIS
  12.      sumtimex [-option ...] [weekno]
  13.  
  14. DESCRIPTION
  15.      The _s_u_m_t_i_m_e_x program takes the files written  by  _t_i_m_e_x  and
  16.      sums them into a single timesheet for the week.
  17.  
  18.      The sums are done from Monday to Sunday; the default week is
  19.      the week that just ended.
  20.      (To get this week, use "now" in place of the week number)
  21.  
  22.      Projects that start with a dash (-) are not included in  the
  23.      sum.
  24.      Projects that start with a plus (+) are  handled  specially;
  25.      see the -adjust command.
  26.  
  27.      Sumtimex is written in  Perl,  so  modifying  it  should  be
  28.      rather easy.
  29.  
  30.  
  31. OPTIONS
  32.      Sumtimex has _l_o_t_s of options. Some of them are listed below.
  33.  
  34.      -round  Round off each sum printed to the nearest half hour.
  35.  
  36.  
  37.      -adjust Take all projects that start with  a  "+"  sign  and
  38.              spread  them  evenly  over  all  the  other projects
  39.              worked on this week.
  40.  
  41.  
  42.      -fudge factor
  43.              Give  the  round-off  point  when  rounding  to  the
  44.              nearest  half  hour.   The  default is 0.5, but that
  45.              will tend to lose you time when you  have  worked  a
  46.              lot on small projects. Sumtimex will print a warning
  47.              if the change is greater than  half  an  hour.   The
  48.              fudge factor should be between 0 and 1.
  49.  
  50.  
  51.      -year nn
  52.              Give the year;  useful  if  you  have  to  make  the
  53.              timesheets for December in January.
  54.  
  55.  
  56.      -name string
  57.              Change the name printed on the top of the timesheet.
  58.              Default  is  your /etc/passwd GECOS field, up to the
  59.              first comma.
  60.  
  61.  
  62.  
  63. ReadyPak                                                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SUMTIMEX(24 May 1993M)ISC. REFERENCE MANUAL PAGES
  71.  
  72.  
  73.  
  74.      -nameadd string
  75.              Add a string (like  your  employee  number)  to  the
  76.              front of your name.
  77.  
  78.  
  79.      -lang code
  80.              Give the language  for  the  form.  Norwegian  (no),
  81.              English  (en),  French (fr), German (de) and Italian
  82.              (it) are more or less included. Comments and contri-
  83.              butions are welcomed!
  84.  
  85.              If not given, sumtimex will attempt to  inspect  the
  86.              LANG  environment  variable,  the  hostname, and the
  87.              domainname to find out what language to use. If  you
  88.              are surprised, drop me a line.
  89.  
  90.  
  91.      -minutes
  92.              Print out the time in  hours  and  minutes  (hh:mm),
  93.              rather than decimal hours.
  94.  
  95.  
  96.      -monthday
  97.              Print out the month  first  then  the  day  (MM/DD),
  98.              rather than the default DD/MM.
  99.  
  100.  
  101.      -debug  Print out a lot of not very useful  information.  If
  102.              you  are surprised by the language chosen, send me a
  103.              printout with -debug on.
  104.  
  105.  
  106. INITFILE
  107.      _s_u_m_t_i_m_e_x will attempt to  read  its  values  from  the  file
  108.      $TIMEXDIR/sumdefaults.   The  format is as the command line,
  109.      with one option per line, and no initial dash.  Command-line
  110.      options override those listed in the sumdefaults file.
  111.  
  112.  
  113. SEE ALSO
  114.      timex(1)
  115.  
  116.  
  117. BUGS
  118.      A lot of the languages have some strings missing. These will
  119.      be  printed  in  English,  with a star (*) in front of them.
  120.      Contributions solicited!
  121.  
  122.  
  123. COPYRIGHT
  124.      Copyright 1990-1993, Harald Tveit Alvestrand
  125.  
  126.  
  127.  
  128.  
  129. ReadyPak                                                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SUMTIMEX(24 May 1993M)ISC. REFERENCE MANUAL PAGES
  137.  
  138.  
  139.  
  140. AUTHORS
  141.      Harald Tveit Alvestrand (DELAB, SINTEF, Norway)
  142.      E-mail: Harald.T.Alvestrand@delab.sintef.no
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. ReadyPak                                                        3
  196.  
  197.  
  198.  
  199.